<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   <title>ImageReader / ImageSource フィルタ</title>
   <link rel="stylesheet" type="text/css" href="../../avisynth.css">
   <link rel="stylesheet" type="text/css" href="../ja.css">
<!--
Automatically generated, don't change:
$Id: imagesource.htm,v 1.1 2008/06/22 07:41:14 ianb1957 Exp $
-->
</head>
<body>
<h2><a NAME="ImageSource"></a>ImageReader / ImageSource
</h2>
<p>
  <code>ImageReader </code>(<var>string &quot;file&quot;, int &quot;start&quot;,
  int &quot;end&quot;, float &quot;fps&quot;, bool
  &quot;use_DevIL&quot;, bool &quot;info&quot;, string &quot;pixel_type&quot;</var>)<br>
  <code>ImageSource </code>(<var>string &quot;file&quot;, int &quot;start&quot;,
  int &quot;end&quot;, float &quot;fps&quot;, bool
  &quot;use_DevIL&quot;, bool &quot;info&quot;, string &quot;pixel_type&quot;</var>)

<p><code>ImageReader</code> は、<em>v2.52</em> から内蔵されています。WarpEnterprises のプラグイン<a href="#footnote_1" class="footnote_link">*1</a>の後継にあたり、いくつかの小さな機能性の変更が行われています。<em>v2.55</em> の時点で、<code>ImageSource </code> はいくつかの小さな機能性の変更をともなった同等物です。画像を 1 枚インポートするときは、<code>ImageReader</code> より <code>ImageSource </code> の方が高速です。</p>
<p><var>file</var>: 画像ファイル用のテンプレート。<cite><a href="http://www.cplusplus.com/ref/cstdio/sprintf.html">sprintf のシンタックス</a></cite>を使って、フレーム番号に置換される文字列を指定することができます。例えば、<code><a href="imagewriter.htm">ImageWriter</a></code> のデフォルトのパラメータによって書き出されたファイルは、<tt>"c:\%06d.ebmp"</tt> で参照することができます。v2.56 現在、テンプレートが単一のファイルを指す場合、そのファイルが一回読み込まれ、つづいてリクエストされるすべてのフレームに対して返されます。</p>
<p><var>start</var> （デフォルト 0）、<var> end</var> （デフォルト 1000）: ファイル名の生成に使用される開始番号と終了番号を指定します。<var>start</var> に対応するファイルはつねにクリップにおけるフレーム 0 で、<var>end</var> に対応するファイルはフレーム (end-start) です。生成されるクリップは、(end-start+1) 枚のフレームを持ちます。「<i>end</i>=0」は、<tt><code><a href="imagewriter.htm">ImageWriter</a></code></tt> のように「上限なし」を意味<b>しません</b><a href="#footnote_2" class="footnote_link">*2</a>。シークエンスにおける最初のファイル、すなわち「start」に対応するファイルは、clip パラメータが算出されるために存在する<b>必要があります</b>。シークエンスの中で不足しているファイルは、空のフレームに置換されます。</p>
<p><var>fps</var> （デフォルト 24）: 返却されるクリップの 1 秒あたりのフレーム数。<em>v2.55</em> より前のバージョンでは整数値。</p>
<p><var>use_DevIL</var> （デフォルト false）: false の場合、まず内部パーサを使って (E)BMP ファイルのパースが試行されます。失敗するとすぐに DevIL<a href="#footnote_3" class="footnote_link">*3</a> による処理が実施されます。true の場合、すぐに DevIL による処理にスキップします。<tt><code>ImageReader</code></tt> の内部パーサによって読み込まれたくない BMP ファイルがある場合にのみ、これを使用する必要があります。</p>
<p><u>注</u>: Avisynth に同梱されている DevIL バージョン 1.6.6 は、パレットを使用する DIB/BMP<a href="#footnote_4" class="footnote_link">*4</a> タイプのファイルを正しくサポートしていません。これには、8 ビット RGB、モノクロ、RLE8 と RLE4<a href="#footnote_5" class="footnote_link">*5</a> が含まれます。この失敗はつねに壊滅的なため、バージョン 2.5.6 からは、内部の BMP 処置は自動的に DevIL にフェイルオーバー<a href="#footnote_6" class="footnote_link">*6</a>しません。これらのファイルタイプに対して DevIL による処理を強制することは、現在のところ、推奨されません。</p>

<p><var>info</var> （デフォルト false）: true の場合、ソースファイル名が各ビデオフレーム上にオーバーレイされます（<em>v2.55</em> で追加）。</p>

<p><var>pixel_type</var> （デフォルト &quot;RGB24&quot;）: 出力ピクセルフォーマットの指定を可能にします。RGB24 と RGB32 の両方がサポートされています。アルファチャンネルは、RGB32 で、かつ、読み込まれた画像フォーマットに関して DevIL がアルファチャンネルをサポートしている場合にのみ読み込まれます（<em>v2.56</em> で追加）。</p>

<p>DevIL が使用された場合、生成されるビデオクリップの色空間は RGB です。DevIL が使用されなかった場合は、EBMP のシークエンスが書き出される元になった色空間です（すべての AviSynth フォーマットがサポートされます）。

<pre># デフォルトのパラメータ: AviSynth が元々備えている
# 1000 フレームの  EBMP シークエンスを（24fps で）読み込む
ImageSource()

# &quot;100.jpeg&quot; から &quot;199.jpeg&quot; までを
# NTSC 方式のクリップに読み込む。
ImageSource(&quot;D:\%d.jpeg&quot;, 100, 199, 29.97)
# 注: v2.56 から浮動小数点数の fps が利用可能

# AviSynth 内蔵の BMP リーダーを使わずに
# &quot;00.bmp&quot; から &quot;50.bmp&quot; までを読みとる
ImageSource(&quot;D:\%02d.bmp&quot;, end=50, use_DevIL=true)

# 単一の画像を読み込んで、300 回繰り返す
ImageSource(&quot;D:\static.png&quot;, end=300)
# v2.56 からさらに高速に</pre>

<p>* 「EBMP」は、YUY2 と YV12 の RAW 画像データの保存を可能にする、標準的な Microsoft RIFF 画像フォーマットの AviSynth 拡張です。詳細は、<a href="imagewriter.htm">ImageWriter</a> を参照してください。</p>
<p><kbd>原文 Date: 2007/05/17 20:56:14</kbd><br />
<kbd>日本語訳 $Date: 2008/06/22 07:41:14 $</kbd></p>
<form><input TYPE="Button" VALUE="戻る"
onClick="history.go(-1)"></form>

<hr />
<div id="footnote">
<ul>
  <li>訳者註:
    <ul>
      <li><a name="footnote_1" class="footnote_link">*1</a> <span class="footnote_text"><a href="http://www.avisynth.org/warpenterprises/#imagesequence">ImageSequence プラグイン</a>のこと。</span></li>
      <li><a name="footnote_2" class="footnote_link">*2</a> <span class="footnote_text">ImageWriter のマニュアルには、「<i>end</i>=0 means last frame（<i>end</i>=0 は最終フレームを意味する）」とあります。詳しくは、<a href="imagewriter.htm">ImageWriter</a> を参照。</span></li>
      <li><a name="footnote_3" class="footnote_link">*3</a> <span class="footnote_text">クロスプラットフォームの画像ライブラリ。Developer's Image Library の略。参考: <a href="http://openil.sourceforge.net/">www.imagelib.org - DevIL - A full featured cross-platform Image Library</a></span></li>
      <li><a name="footnote_4" class="footnote_link">*4</a> <span class="footnote_text">参考: <a href="http://www.geocities.co.jp/Playtown-Knight/6845/sd_doc/format_windib.html">BMP形式（Wndows DIB）</a></span></li>
      <li><a name="footnote_5" class="footnote_link">*5</a> <span class="footnote_text">Run-Length Encoding（連長圧縮）の略。RLE8 は 8 ビット圧縮（256 色）、RLE4 は 4 ビット圧縮（16 色）。参考: <a href="http://ja.wikipedia.org/wiki/%E9%80%A3%E9%95%B7%E5%9C%A7%E7%B8%AE">連長圧縮 - Wikipedia</a>, <a href="http://yougo.ascii24.com/gh/09/000985.html">ASCII24 - アスキー デジタル用語辞典 - Run-Lengthエンコーディング</a></span></li>
      <li><a name="footnote_6" class="footnote_link">*6</a> <span class="footnote_text">参考: <a href="http://e-words.jp/w/E38395E382A7E382A4E383ABE382AAE383BCE38390E383BC.html">フェイルオーバーとは 【fail over】 - 意味・解説 ： IT用語辞典</a></span></li>
    </ul>
  </li>
</ul>
</div>

</body>
</html>
